-
Notifications
You must be signed in to change notification settings - Fork 164
Typed Spans: Create RFC from current WIP proposal. #25
Conversation
## Proposal | ||
* Add a field `CanonicalType` that contains the type of span | ||
* Define mandatory and optional attributes per span type | ||
* Provide an API that supports creating typed spans and ensures that at least all |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I would really like to see an actual proposal of the API for doing this. Especially if it was already POCed in Node, what's preventing it from becoming a part of this RFC? Without the API proposal this current document provides little value, since it's not directly usable.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Should we make language-specific RFCs? Not all languages support the same capabilities which makes writing specs for APIs a challenge. We can, however, link to the language spec files or should we rather use same pseudo code?
Beyond the discussion above we should move these files over. This is just an administrative task rather than any substantial change to the spec. @tedsuo and @bogdandrutu can you please approve. |
I think this proposal is missing an important element: declaring which parts of the attribute namespace are "reserved" for typed span data, which are for user attributes, etc. (e.g. can we declare that regardless of the type of the span, that most application data should be, for instance, prefixed with |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
In subsequent conversations, we've moved from a single span type to composing semantic conventions as a mechanism for recording this information.
As requested, I'm approving this so that we can record it as proposed
so that we can move it from the spec repo.
I believe this PR is a little bit ambiguous as it is. IMHO, it should be split into multiple standalone-pieces:
|
Closing this PR after some discussion.
|
Since the "work in progress" folder is about to get removed from the repository (open-telemetry/opentelemetry-specification#225), the proposal concerning "typed spans" will be moved from there into the RFC repo.
See original discussion: open-telemetry/opentelemetry-specification#14